package com.mkx.domain.repository;

import com.mkx.domain.entity.TenantUser;

import java.util.List;
import java.util.Optional;

/**
 * 租户用户仓储接口
 * 定义租户用户实体的持久化操作
 */
public interface TenantUserRepository {
    
    /**
     * 根据ID查找租户用户
     * @param id 租户用户ID
     * @return 租户用户实体，如果不存在则返回空
     */
    Optional<TenantUser> findById(String id);
    
    /**
     * 根据租户ID和用户ID查找租户用户关联
     * @param tenantId 租户ID
     * @param userId 用户ID
     * @return 租户用户实体，如果不存在则返回空
     */
    Optional<TenantUser> findByTenantIdAndUserId(String tenantId, String userId);
    
    /**
     * 根据租户ID查找该租户下的所有用户
     * @param tenantId 租户ID
     * @return 租户用户实体列表
     */
    List<TenantUser> findByTenantId(String tenantId);
    
    /**
     * 根据用户ID查找该用户在所有租户中的关联
     * @param userId 用户ID
     * @return 租户用户实体列表
     */
    List<TenantUser> findByUserId(String userId);
    
    /**
     * 根据租户ID和角色ID查找用户
     * @param tenantId 租户ID
     * @param roleId 角色ID
     * @return 租户用户实体列表
     */
    List<TenantUser> findByTenantIdAndRoleId(String tenantId, String roleId);
    
    /**
     * 保存租户用户关联（新增或更新）
     * @param tenantUser 租户用户实体
     * @return 保存后的租户用户实体
     */
    TenantUser save(TenantUser tenantUser);
    
    /**
     * 删除租户用户关联
     * @param id 租户用户ID
     * @return 是否删除成功
     */
    boolean deleteById(String id);
    
    /**
     * 删除租户与用户的关联
     * @param tenantId 租户ID
     * @param userId 用户ID
     * @return 是否删除成功
     */
    boolean deleteByTenantIdAndUserId(String tenantId, String userId);
    
    /**
     * 删除用户在所有租户中的关联
     * @param userId 用户ID
     * @return 删除的记录数
     */
    int deleteByUserId(String userId);
    
    /**
     * 删除租户下的所有用户关联
     * @param tenantId 租户ID
     * @return 删除的记录数
     */
    int deleteByTenantId(String tenantId);
    
    /**
     * 批量保存租户用户关联
     * @param tenantUsers 租户用户实体列表
     * @return 保存后的租户用户实体列表
     */
    List<TenantUser> saveAll(List<TenantUser> tenantUsers);
    
    /**
     * 分页查询租户下的用户
     * @param tenantId 租户ID
     * @param page 页码（从1开始）
     * @param size 每页大小
     * @return 租户用户实体列表
     */
    List<TenantUser> findByTenantId(String tenantId, int page, int size);
    
    /**
     * 统计租户下的用户数量
     * @param tenantId 租户ID
     * @return 用户数量
     */
    long countByTenantId(String tenantId);
    
    /**
     * 检查租户和用户的关联是否存在
     * @param tenantId 租户ID
     * @param userId 用户ID
     * @return 是否存在
     */
    boolean existsByTenantIdAndUserId(String tenantId, String userId);
}